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You may have wondered, as I have, why nobody has ever come up with any kind of comprehensive 
listing of the Mac's ROM traps and global variables. So far, the lists in existence are scattered in many 
widely varying sources. For example, Apple's Inside Macintosh contains ROM trap listings in both 
alphabetical and numeric orders, but its global variable list is both incomplete and in alphabetic order 
only. Having lists ordered by memory address helps make debugging with TMON and Macsbug much 
easier. It also helps programmers using 68000 assembly language, such as myself. 

Apple's official policy is that programmers should use the names of variables when writing their 
programs. Their reasoning is that the use of names will prevent incompatibilities with future Macs 
and/or system files. I don't follow that policy for two reasons. First, the only way to create 
incompatibilities is for Apple to change the locations of some or all of the global variables in a future 
release of system software. Doing this would immediately invalidate the entire Macintosh software 
base, so I don't think Apple would seriously think of it. Secondly, encoding the actual addresses helps 
debugging since my source code becomes closer to the object code. This is efficient because I only 
have to look up variable names once when writing source code and eliminates multiple lookups when 
debugging with Macsbug. Normally I use variable addresses in my source code and place variable 
names in comment lines. 

After struggling with the separated lists, I decided to improve my productivity by centralizing all that 
information in a master file. This master file, MacAlmanac, has since helped me greatly. Its distribution 
as PD (Public Domain) made sense, so others could benefit as well. 

It would be a good idea to print this file in its entirety and three-hole punch it for placement in a 
binder. This file has been reformatted for printing on the LaserWriter, and for completeness, the laser 
font Times has been substituted for the screen font Geneva used in Almanac I. The master list will be a 
time-saver for you, regardless of what development system you are using (Pascal, C, BASIC, 
FORTRAN, Lisp, Forth, etc.). It will also help you if you disassemble bits of ROM code or other 
hacker stuff. 


Revision History: 


VERSION DATE PAGES CHANGES 

I 1.0 28 January 1987 26 Created, first release 

I 1.1 12 May 1987 27 Added: Errors on Powerup 

I 1.2 25 October 1987 29 Added: Traps & Keyboards 

I 1.3 16 December 1987 29 Altered pages 19, 27, and 28 

I 1.4 30 December 1987 29 Fonts table reorganized (Page 26) 

I 1.5 18 April 1988 30 Added: new global variables 

Il 1.0 4 June 1990 32 Total rewrite of Almanac I, first rerelease 


If you need to contact me, I can be reached at my home address: 
James H. Olson 
4515 Hurley Street 
Philadelphia, PA 19120-4528 
(215) 457-7114 (answering machine) 


*e* MIAC ALMANAC IS IN THE PUBLIC DOMAIN *** 
Apple, Macintosh, Mac, and ResEdit are trademarks registered to Apple Computer, Inc. 
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PART 1 


Global Variables in Memory Address Order 


Simply, global variables on the Macintosh™ are variables that hold values that are independent of 
any running program and don't usually change value when one program quits and another starts. These 
variables are all assigned as a group to one or two large blocks of RAM located between location 0 (the 
start of RAM) and the system and application areas of RAM. Each variable is assigned a specific 
memory location. Values stored in these variables usually contain information such as the amount of 
RAM installed in the Mac, the version of ROM, system, and Finder installed, mouse location, serial port 
settings, and the like. Programs can read and write to any of these variables, and writes will have lasting 
effects on the system (until changed again). Upon startup, and again if the Mac is reset, just about all 
variables are initialized by the ROM startup code after any memory tests (see Part 6). 

Since the Mac was introduced in 1984, Apple has encouraged people writing Mac software to read 
and write to global variables by using their names. When language compilers see these names, they get 
the equivalent addresses from an "include" file specified during the compilation process. The final 
program only has the memory addresses. Also since 1984, Apple has made press announcements and 
other talk about getting rid of global variables, or at least making major changes. This verbal noise was 
particularly evident when Switcher™ (later MultiFinder™) was released. It turns out that changing 
existing global variables would create a mass confusion big enough to jeopardize the entire Mac 
product line. Because all existing Mac software (system, application, DA, INIT, etc.) depends on 
globals, even if the software doesn't access globals directly, changing them would instantly invalidate 
the entire Mac software base. Apple cannot arbitrarily change the locations of these variables without 
creating problems with just about every Macintosh program on the market. Because of this restraining 
effect, Apple only makes improves existing variables or adds new ones. A good example of this is the 
variable BootDrive (located at $210). Under the original 64K ROM it contained the drive number 
where the boot floppy was located. When HFS was introduced in 1986, BootDrive was changed to 
hold the volume/directory reference number of the boot disk. This change made BootDrive more useful 
now that hard disks are frequently used as the boot disk, yet remains compatible with floppies. 

I have attempted to give the most complete listings possible, drawing from several sources. For 
instance, Apple's Inside Macintosh gives only a partial listing of global variables in alphabetical order. 
My list is in memory address order, which is better suited to debugging with MacsBug and other 
monitor-like debuggers. The list also exposes "holes": locations Apple hasn't yet made public. While 
compiling the list, I noticed some variables had more than one name. From what I can decipher, many 
of these variables were used during the original development of the Macintosh before its release in 
1984 and fell into disuse afterwards. Some even have strange names like "MonkeyLives" ($100) and 
"MrMacHook" ($A2C). Microsoft even had a location named after it ($A78- now ApplScratch), and a 
location was named after the infamous "Twiggy" 5.25-inch floppy disk drives on the original Lisa 
(TwiggyVars, $128). Alternate names appear probably because Apple re-used these locations for new 
variables while developing the 128K ROM. Another good example is ROM85. Under the old 64K 
ROM, this was an non-public location that held -1. Under all newer ROMs, this location always holds a 
positive value. 

In the following list, old names from the 64K ROM are noted by a dot "*" in the left column before 
their names. Note that certain sections of memory have special names declared. These area-designators 
look like variables but are easy to pick out- their size fields contain hyphens. All locations that haven't 
been made public are marked with "[????]". 


Variable Location Size Description 


SysCom $100 - start of System communication area 
MonkeyLives $100 word monkey lives if nonzero 

ScrVRes $102 word screen vertical dots/inch 

ScrHRes $104 word screen horizontal dots/inch 
ScreenRow $106 word rowBytes of screen 

MemTop $108 long ptr to end of RAM 
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BufPtr $10C long ptr to end of jump table 

StkLowPt $110 long lowest stack pointer value as measured in VBL task 
HeapEnd $114 long ptr to end of application heap 

TheZone $118 long ptr to current heap zone 

UTableBase $11C long ptr to unit I/O table 

MacJmp $120 long ptr to jump vector table used by MacsBug 
DskRtnAdr $124 long temporary pointer used by Disk Driver 

Twiggy Vars $128 long ptr to ‘other’ driver variables (Lisa 5.25" drive) 
PollRtnAddr $128 long ptr to ‘other’ driver variables (Lisa 5.25" drive) 
DskVerify $12C byte used by Mac 3.5" Disk Driver for read/verify 
LoadTrap $12D byte trap before launch? 

MmInOK $12E byte Initial Memory Manager checks ok? 

DskWr11 $12F byte try 1-1 disk writes? 

CPUFlag $12F byte code for installed CPU: 0=68000, 1=68010, 2=68020, 3=68030 
ApplLimit $130 long address of application heap limit 

SonyVars $134 long ptr to Mac 3.5" Disk Driver variables 

PWMValue $138 word current PWM value 

PollStack $13A long address of SCC poll data start stack location 
PollProc $13E long ptr to SCC poll data procedure 

DskErr $142 word disk routine result code 

SysEvtMask $144 word system event mask 

SysEvtBuf $146 long ptr to system event queue element buffer 
EventQueue $14A 10 event queue header 

EvtBufCnt $154 word maximum #of events in SysEvtBuf minus 1 
RndSeed $156 long random number seed 

SysVersion $15A word System file version number (e.g. System 4.1=$0410) 
SEvtEnb $15C byte 0 = SysEvent always returns FALSE 

DSWndUpdate $15D byte GetNextEvent not to paint behind System error dialog? 
FontFlag $15E byte font manager loop flag 

Filler3 $15F byte 1 byte of filler 

VBLQueue $160 10 VBL queue header 

Ticks $16A long Tick count: time since system startup (tick=1/60 sec) 
MBTicks $16E long tick count when mouse button was last pressed 
MBState $172 byte current mouse button state 

Tocks $173 byte Lisa sub-tick count 

KeyMap $174 8 bitmap of the keyboard 

KeypadMap $17C long bitmap for numeric keypad (uses 18 bits) 

(?2??] $180 long <unknown location> 

KeyLast $184 word ASCH code for last valid keycode 

KeyTime $186 long tickcount when KEYLAST was received 
KeyRepTime $18A long tick count when key was last repeated 

KeyThresh $18E word threshold for key repeat 

KeyRepThresh $190 word key repeat speed 

Lv11DT $192 32 Level-1 secondary interrupt vector table 

Lv12DT $1B2 32 Level-2 secondary interrupt vector table 

UnitNtryCnt $1D2 word count of entries in unit table 

VIA $1D4 long base address of 6522 VIA chip 

SCCRd $1D8 long address of Z8530 SCC chip (used when reading the chip) 
SCCWr $1DC long address of Z8530 SCC chip (used when writing the chip) 
IWM $1E0 long base address of WM chip (floppy drive controller) 
scratch20 $1E4 20 general scratch area 

SysParam $1F8 - System parameter RAM vars (PRAM info) 

SPValid $1F8 byte validation: $A8 if last write to clock chip was good 
SPATalkA $1F9 byte AppleTalk node ID for modem port 

SPATalkB $1FA byte AppleTalk node ID for printer port 

SPConfig $1FB byte serial-port-in-use flags for both ports 

SPPortA $1FC word modem port configuration (baud, parity, bits) 
SPPortB $1FE word printer port configuration (baud, parity, bits) 
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SPAlarm 
SPFont 
SPKbdPrint 
SPKbd 
SPPrint 
SPVoIClik 
SPVoICtl 
SPClikCaret 
SPMisc 
SPMisc2 
Time 
BootDrive 
BootDrive 
JShell 
Filler3A 
SFSaveDisk 
KbdVars 
(22??] 
KbdLast 
[2229] 
JKybdTask 
KbdType 
AlarmState 
CurlOTrap 
MemErr 
DiskVars 
(22??] 
FlEvtMask 
SdVolume 
SdEnable 
SoundVars 
SoundPtr 
SoundBase 
SoundVBL 
SoundDCE 
SoundActive 
SoundLevel 
CurPitch 
SoundLast 
(22??] 

(22??] 
ROM85 
PortAUse 
PortBUse 
ScreenVars 
(22??] 

(22??] 
JGNEFilter 
Key1Trans 
Key2Trans 
SysZone 
App|Zone 
ROMBase 
RAMBase 
BasicGlob 
DSAlertTab 
ExtStsDT 
SCCASts 


$200 
$204 
$206 
$206 
$207 
$208 
$208 
$209 
$20A 
$20B 
$20C 
$210 
$210 
$212 
$214 
$214 
$216 
$216 
$218 
$219 
$21A 
$21E 
$21F 
$220 
$220 
$222 
$222 
$25E 
$260 
$261 
$262 
$262 
$266 
$26A 
$27A 
$27E 
$27F 
$280 
$282 
$286 
$28A 
$28E 
$290 
$291 
$292 
$292 
$296 
$29A 
$29E 
$2A2 
$2A6 
$2AA 
$2AE 
$2B2 
$2B6 
$2BA 
$2BE 
$2CE 


long 
word 
word 
byte 
byte 
word 
byte 
byte 
byte 
byte 
long 
word 
word 
word 
word 
word 
word 
byte 
byte 
long 
byte 
byte 
word 
word 
60 

word 


alarm clock setting 

font number of application font minus 1 

auto-key threshold/rate and printer connection 
auto-key threshold and rate 

printer connection 

speaker volume; double click and caret flash times 
speaker volume 

double click and caret flash times 

reserved for future use 

mouse tracking, startup floppy drive, menu blink 
current date/time (seconds since midnight 1 JAN 1904) 
drive number of boot drive 

working directory reference number of boot disk 
journaling shell state 

negative of vVRefNum last seen by Standard File Package 
negative of vVRefNum last seen by Standard File Package 
Keyboard manager variables 

<unknown location> 

ADB address of keyboard last used 

<unknown location> 

ptr to keyboard VBL task hook 

keyboard model number 

alarm clock: Bit7=parity, Bit6=beeped, Bit0=enable 
current I/O trap being executed 

Memory Manager error code 

Disk driver variables (60 bytes) 

<unknown locations> 

mask of flushable events (FlushEvents) 

Current speaker volume (bits 0 through 2 only) 
Sound enabled? 

Sound driver variables (32 bytes) 

pointer to 4-voice sound definition (SynthRec) 

ptr to free-form sound definition (SynthRec) 
vertical retrace control element 

pointer to Sound Driver's device control entry 
sound is active? 

current amplitude in 740-byte sound buffer 

current value of COUNT in square-wave SynthRec 
address past last sound variable 

<unknown location> 

<unknown location> 

holds a positive value if 128K or later ROM in Mac 
Port A usage: if zero, port available 

Port B usage: if zero, port available 

Screen driver variables (8 bytes) 

<unknown location> 

<unknown location> 

ptr to GetNextEvent filter procedure 

ptr to keyboard translator procedure 

ptr to numeric keypad translator procedure 

starting address of system heap zone 

starting address of application heap zone 

base address of ROM (Trap Dispatcher) 

base address of RAM (Trap Dispatcher) 

ptr to BASIC globals 

ptr to system error alert table in use 
External/status interrupt vector table 

SCC read register 0 last external/status interrupt - A 
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SCCBSts 
Serial Vars 
(222?] 

(22??] 
ABusVars 
(22??] 
FinderName 
DoubleTime 
CaretTime 
ScrDmpEnb 
ScrDmpType 
TagData 
(22??] 
BufTgFNum 
BufTgFFlg 
BuffgFBkNum 
BufTgDate 
DrvQHdr 
PWMBuf2 
HpChk 
MaskBC 
MaskHandle 
MaskPtr 
Lo3Bytes 
MinStack 
DefltStack 
MMDefFlags 
GZRootHnd 
GZRootPtr 
GZMoveHnd 
DSDrawProc 
EjectNotify 
IAZNotify 
File Vars 
CurDB/CkdDB 
FSCallAsync 
NxtDB 
MaxDB 
FlushOnly 
RegRsrc 
FLckUnIck 
FreSync 
NewMount 
NoEject 
DrMstrBlk 
HFS Globals 
FCBSPtr 
DefVCBPtr 
VCBQHdr 
FSQHdr 
HFSVars 
HFSStkTop 
HFSStkPtr 
WDCBsPtr 
HFSFlags 
SysCRefCnt 
CacheFlag 
SysBMCPtr 


$2CF 
$2D0 
$2D0 
$2D4 
$2D8 
$2DC 
$2E0 
$2F0 
$2F4 
$2F8 
$2F9 
$2FA 
$2FA 
$2FC 
$300 
$302 
$304 
$308 
$312 
$316 
$31A 
$31A 
$31A 
$31A 
$31E 
$322 
$326 
$328 
$32C 
$330 
$334 
$338 
$33C 
$340 
$340 
$342 
$342 
$344 
$346 
$347 
$348 
$349 
$34A 
$34B 
$34C 
$34E 
$34E 
$352 
$356 
$360 
$36A 
$36A 
$36E 
$372 
$376 
$377 
$377 
$378 


byte 


long 
long 
long 
long 
16 

long 
long 
byte 
byte 
word 
long 
word 
word 
long 
10 

long 
long 
long 
long 
long 
long 
long 
long 
word 
long 
long 
long 
long 
long 
long 
word 
word 
word 
word 
byte 
byte 
byte 
byte 
byte 


SCC read register 0 last external/status interrupt - B 
async driver variables (16 bytes) 

<unknown location> 

<unknown location> 

ptr to AppleTalk variables 

<unknown location> 

name of the shell, usually "Finder" (STRING[15]) 
double click interval in ticks 

caret blink interval in ticks 

screen dump enable - zero disables FKEY processing 
$FF dumps screen, $FE dumps front window (FKEY 4) 
sector tag info for disk drivers (14 bytes) 
<unknown location> 

File tags buffer: file number 

File tags buffer: flags (bitl=1 if resource fork) 
File tags buffer: logical block number 

File tags buffer: last modification date/time 
queue header of drives in system 

ptr to PWM buffer 1 (or 2 if sound) 

heap check RAM code 

Memory Manager byte count mask 

Memory Manager handle mask 

Memory Manager pointer mask 

holds the constant $00FFFFFF 

minimum stack size used in InitApplZone 
default size of stack 

default zone flags 

root handle for GrowZone 

root pointer for GrowZone 

moving handle for GrowZone 

ptr to alternate system error draw procedure 

ptr to eject notify procedure 

ptr to world swaps notify procedure 

file system vars (184 bytes) 

current dir block/used for searches 

"One byte free" 

<no description available> 

<no description available> 

flag used by UnMountVol and FlushVol 

flag used by OpenRF and FileOpen 

flag used by SetFilLock and RstFilLock 

when set, all file system calls are synchronized 
used by MountVol to flag new mounts 

used by Eject and Offline 

master directory block in a volume 

HFS global variables (168 bytes) 

ptr to file control block buffer 

ptr to default volume control block 

volume control block queue header 

file I/O queue header 

Start of TFS variables (RAM version) 

Temp location of stack ptr during async calls 
Temporary location of HFS stack ptr 

Working Directory queue header 

Internal HFS flags 

system cache usage count (#of vols) 

system cache usage count now used as cache flag 
System-wide bitmap cache pointer 
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SysVolCPtr 
SysCtlCPtr 
DefVRefNum 
PMSPPtr 
HFSDSErr 
HFS VarEnd 
CacheVars 
CurDirStore 
(22??] 
CacheCom 
(22??] 

ErCode 
Params 

(22??] 
FSTemp8 
FSTemp4 
FSIOErr 
(?2??] 
FSQueueHook 
ExtFSHook 
DskSwtchHook 
ReqstVol 
ToExtFS 

FS VarEnd 
FSFCBLen 
DSAlertRect 


DispatchTab 
OSDispTable 


GRAFBEGIN 
JHideCursor 
JShowCursor 
JShieldCursor 
JScrnAddr 
JScrmSize 
JInitCrsr 
JSetCrsr 
JCrsrObscure 
JUpdateProc 
LGrafJump 
GrafVar 
ScrnBase 
MTemp 
RawMouse 
NMouse 
CrsrPin 
CrsrRect 
TheCrsr 
CrsrAddr 
CrsrSave 
CrsrSave 
(22??] 
MainDevice 
DeviceList 
(22??] 
QDColors 
CrsrVis 


$37C 
$380 
$384 
$386 
$392 
$394 
$394 
$398 
$39A 
$39C 
$3A0 
$3A2 
$3A4 
$3A4 
$3D6 
$3DE 
$3DE 
$3E0 
$3E2 
$3E6 
$3EA 
$3EE 
$3F2 
$3F6 
$3F6 
$3F8 


$400 
$400 


$800 
$800 
$804 
$808 
$80C 
$810 
$814 
$818 
$81C 
$820 
$824 
$824 
$824 
$828 
$82C 
$830 
$834 
$83C 
$844 
$888 
$88C 
$88C 
$890 
$8A4 
$8A8 
$8AC 
$8B0 
$8CC 


long 
long 
word 
long 
word 
8 

word 
word 
long 
word 
word 


System-wide volume cache pointer 
System-wide control cache pointer 

Default volume's VRefNum/WDRefNum 

ptr to list of directories on PMSP 

Final gasp - error that caused JOErr 

End of HFS variable area 

<no description available> 

ID of last directory opened 

<unknown location> 

<no description available> 

<unknown location> 

report errors here during async routines 

File Mgr I/O ParamBlock (50 bytes) 
<unknown locations> 

used by Rename 

used by Rename and CkFilMod 

last I/O error 

<unknown location> 

ptr to hook to capture all FS calls 

ptr to command done hook 

ptr to hook for disk-switch dialog 

ptr to offline or external file system volume VCB 
ptr to external file system 

end of file system variables 

size of file control block; contains -1 on 64K ROM Macs 
rectangle for system error and disk-switch alerts 


OS & Toolbox trap dispatch table (64K ROM) (512 words) 
OS trap dispatch table (128K and later ROM) (256 longs) 


graf (QuickDraw) global area 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
<no description available> 
QuickDraw variables 

base address of main screen 
low-level interrupt mouse location 
un-jerked mouse coordinates 
processed mouse coordinate 
cursor pinning rectangle 
cursor hit rectangle 

cursor data, mask & hotspot 
address of data under cursor 
data under the cursor 

ptr to data under the cursor 
<unknown locations> 

handle to current main device 
handle to first element in device list 
<unknown location> 

default QuickDraw colors 
cursor visible? 
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CrsrBusy $8CD byte cursor locked out? 

CrsrNew $8CE byte cursor changed? 

CrsrCouple $8CF byte cursor coupled to mouse? 

CrsrState $8D0 word cursor nesting level 

CrsrObscure $8D2 byte Cursor obscure semaphore 

CrsrScale $8D3 byte cursor scaled? 

(?2??] $8D4 word <unknown location> 

MouseMask $8D6 long V-H mask for ANDing with mouse 
MouseOffset $8DA long V-H offset for adding after ANDing 
JournalFlag $8DE word journaling state 

JSwapFont $8E0 long jump entry for FMSwapFont 

JFontInfo $8E4 long jump entry for FMFontMetrics 
WidthListHand $8E4 long handle to a list of handles of recently-used width tables 
JournalRef $8E8 word Journalling driver's refnum 

(?2??] $8EA word <unknown location> 

CrsrThresh $8EC word delta threshold for mouse scaling 

JCrsrTask $8EE long address of CrsrVBLTask 

GRAFEND $8F2 - End of graphics globals 

WWExist $8F2 byte window manager initialized? 

DExist $8F3 byte QuickDraw is initialized 

JFetch $8F4 long ptr to fetch-a-byte routine for drivers 

JStash $8F8 long ptr to stash-a-byte routine for drivers 

JIODone $8FC long ptr to IODone routine for drivers 

LoadVars $900 - Segment Loader variables (68 bytes) 
CurApRefNum $900 word refNum of current application's resFile 
LaunchFlag $902 byte Tells whether Launch or Chain was last called 
(?2??] $903 byte <unknown location> 

CurrentA5 $904 long current value of register A5 

CurStackBase $908 long ptr to the base (beginning) of the stack 

(?2??] $90C long <unknown location> 

CurApName $910 32 name of current application (STRING[31]) 
SaveSegHandle $930 long handle to segment 0 (CODE 0) 

CurJTOffset $934 word current jump table offset from register A5 
CurPageOption $936 word current page 2 configuration (screen/sound buffers) 
HiliteMode $938 word set to -1 if hilighting mode is on, 0 otherwise 
LoaderPBlock $93A 10 param block for ExitToShell 

PrintVars $944 16 print code variables 

LastLGlobal $944 long address past last loader global 

PrintErr $944 word Print Manager error code 

(????] $946 14 <unknown locations> 

CoreEditVars $954 12 core edit variables 

LastPGlobal $954 long address of last printer global 

(?2??] $958 long <unknown location> 

(????] $95C long <unknown location> 

scrap Vars $960 - Scrap Manager variables (32 bytes) 

scrapInfo $960 long scrap length 

scrapSize $960 long scrap length 

scrapHandle $964 long handle to RAM scrap 

scrapCount $968 word count changed by ZeroScrap 

scrapState $96A word scrap state: tells if scrap exists in RAM or on disk 
scrapName $96C long pointer to scrap file name (normally "Clipboard File") 
scrapTag $970 16 scrap file name (STRING[15]) 

scrapEnd $980 - End of scrap vars 

ToolGBase $980 - base address of toolbox globals 

ToolVars $980 toolbox variables 


RomFont0 $980 long handle to system font 
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ApFontID 
ApFontID 
GotStrike 
FMDefaultSize 
CurFMInput 
CurFMFamily 
CurFMSize 
CurFMFace 
CurFMNeedBits 
CurFMDevice 
CurFMNumer 
CurFMDenom 
FMegrOutRec 
FOutError 


TFOutFontHandle 


FOutBold 
FOutlItalic 
FOutULOffset 
FOutULShadow 
FOutULThick 
FOutShadow 
FOutExtra 
FOutAscent 
FOutDescent 
FOutWidMax 
FOutLeading 
FOutUnused 
FOutNumer 
FOutDenom 
FMDotsPerInch 
FMStyleTab 
ToolScratch 
WindowList 
SaveUpdate 
PaintWhite 
WMegrPort 
DeskPort 
OldStructure 
OldContent 
GrayRgn 
SaveVisRgn 
DragHook 
scratch8 
TempRect 


OneOne 
MinusOne 
TopMenultem 
AtMenuBottom 
IconBitmap 
MenuList 
MBarEnable 
CurDeKind 
MenuFlash 
TheMenu 
SavedHandle 
MrMacHook 
MBarHook 


$984 
$984 
$986 
$987 
$988 
$988 
$98A 
$98C 
$98D 
$98E 
$990 
$994 
$998 
$998 
$99A 
$99E 
$99F 
$9A0 
$9A1 
$9A2 
$9A3 
$9A4 
$9A5 
$9A6 
$9AT7 
$9A8 
$9A9 
$9AA 
$9AE 
$9B2 
$9B6 
$9CE 
$9D6 
$9DA 
$9DC 
$9DE 
$9E2 
$9E6 
$9EA 
$9EE 
$9F2 
$9F6 
$9FA 
$9FA 


$A02 
$A06 
$A0A 
$A0C 
$A0E 
$A1C 
$A20 
$A22 
$A24 
$A26 
$A28 
$A2C 
$A2C 


word 
word 
byte 
byte 
long 
word 
word 
byte 
byte 
word 
long 
long 
long 
word 
long 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
byte 
long 
long 
long 
24 

8 
long 
word 
word 
long 
long 
long 
long 
long 
long 
long 


resource ID of application font 

font number of application font 

Do we have the strike? 

default size 

ptr to QuickDraw FMInput record 
current font family 

current font size 

current font face 

boolean telling whether it needs strike 
current font device 

current numerator of scale factor 
current denominator of scale factor 

ptr to QuickDraw FontOutput record 
Font Manager error code 

handle to font bits 

bolding factor 

italic factor 

underline offset 

underline halo 

underline thickness 

shadow factor 

extra horizontal width 

height above baseline 

height below baseline 

maximum width of character 

space between lines 

unused (padding) byte -must have even number 
point for numerators of scale factor 
point for denominators of scale factor 
h,v dotsPerInch (resolution) of current device 
style heuristic table given by device 
scratch area 

ptr to Z-ordered linked list of windows 
Enable update events? 

erase windows before update event? 
ptr to window manager's grafport 

ptr to Desk grafPort (Whole screen) 
handle to saved structure region 
handle to saved content region 

handle to rounded-corner region drawn as the desktop 
handle to temporarily saved visRegion 
ptr to user hook called during dragging 
general scratch area 

scratch rectangle 


holds the constant $00010001 

holds the constant $FFFFFFFF 

pixel value of top of scrollable menu 

flag for menu scrolling 

scratch bitmap used for plotting things 

handle to current menuBar list structure 

menuBar enable for desk acc's that own the menu bar 
window kind of deactivated window 

flash feedback count 

resource ID of hilited menu 

handle to data under a menu 

Mr. Macintosh hook 

ptr to MenuSelect hook called before menu is drawn 
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MenuHook 
DragPattern 
DeskPattern 
DragFlag 
CurDragAction 
FPState 
TopMapHndl 
SysMapHndl 
SysMap 
CurMap 
ResReadOnly 
ResLoad 
ResErr 
TaskLock 
FScaleDisable 
CurActivate 
CurDeactive 
DeskHook 
TEDoText 
TERecal 
MicroSoft 
ApplScratch 
GhostWindow 
CloseOrnHook 
ResumeProc 
SaveProc 
SaveSP 
ANumber 
ACount 
DABeeper 
DAStrings 
TEScrpLengt 
TEScrpHandl 
AppPacks 
SysResName 
AppParmHandle 
DSErrCode 
ResErrProc 
TEWdBreak 
DlgFont 
LastTGLobal 


$A30 long ptr to user hook called during MenuSelect 
$A34 8 pattern used to draw outlines of dragged regions 
$A3C 8 pattern used for the desktop 

$A44 word implicit parameter to DragControl 

$A46 long ptr to implicit actionProc for dragControl 
$A4A 6 floating point state 

$A50 long handle to map of most recently opened resource file 
$A54 long handle to map of System resourc file 

$A58 word reference number of System resource file 
$AS5A word reference number of current resource file 
$A5C word Read-only flag 

$A5E word Auto-load feature 

$A60 word Resource Manager error code 

$A62 byte re-entering SystemTask 

$A63 byte disable font scaling? 

$A64 long ptr to window slated for activate event 

$A68 long ptr to window slated for deactivate event 
$A6C long ptr to hook for painting the desk 

$A70 long ptr to textEdit doText proc hook 

$A74 long ptr to textEdit recalText proc hook 

$A78 12 Appl|Scratch - for Seattle font 

$A78 12 application scratch area 

$A84 long ptr to window never to be considered frontmost 
$A88 long ptr to hook for closing desk ornaments 

$A8C long ptr to Resume procedure (System error dialog) 
$A90 long address of Save failsafe procedure 

$A94 long Safe stack ptr for restart or save 

$A98 word resID of last alert 

$A9A word number of times last alert was called (0 through 3) 
$A9C long ptr to current beep routine 

$AA0 16 paramText substitution strings (4 handles) 
$ABO long textEdit Scrap Length 

$AB4 long handle to textEdit Scrap 

$AB8 32 Handles to PACK resources (ID's from 0 to 7) 
$AD8 20 name of system resource file (STRING[19]) 
$AEC long handle to hold application parameters 

$AFO word last (or current) system error alert ID 

$AF2 long ptr to Resource Manager error procedure 

$AF6 long ptr to default word break routine 

$AFA word current font number for dialogs and alerts 
$AFC long address of last global 


The contents of memory locations from $B00 on up depend on the ROM version installed. 
¢ 64K ROM Macs: 


these Macs have a single trap dispatch table located at $400 through $7FF. The system 
heap begins at $B00, leaving no room for additional globals. 


¢ 128K and later ROM: the original trap dispatch table at $400 through $7FF was converted for use by the 


HeapStart 
TrapAgain 
[227] 


Operating System, and a second trap dispatch table for Toolbox traps was created at $CO00. 
length is 2K on the Mac Plus and SE, and 4K on the SE/30 and II series. The intervening 
space from $B00 through $BFF was reserved for new global variables. Note that some 
globals were defined within the trap table, with addresses above $C00. While I do not 
understand why Apple did this, the effect is that a few table entries have been pre-empted, 
reducing the table's capacity. As explained in the Trap Dispatcher section below, each A-trap 
expects a routine address to be stored in the trap table. Since some of these locations were 
used for globals, the affected A-traps cannot be used (more on this later). 


$B00 - start of the System Heap on 64K ROM Macs 
$B00 long use 4 bytes here for another trap 
$B04 word <unknown location> 
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ROMMapHndl 
PWMBuf1 
BootMask 
WidthPtr 
AtalkHk1 
AtalkHk2 
[2722] 

[2727] 
HWCfgFlags 
SCSIFlag 
[2727] 
WidthTabHandle 
[2227] 
BtDskRfn 
BootTmp8 
[2727] 
T1Arbitrate 
[227] 
MenuDisable 
[2222] 
<switched vars> 
RMGRHiVars 
[2227] 
RomMapInsert 
TmpResLoad 
IntlSpec 

[2227] 
SysFontFam 
SysFontSize 
MBarHeight 
[2722] 
NewUnused 
LastFOND 
[2227] 
FractEnable 
[2727] 

[2222] 
ToolDispTable 
ToolDispTable 
HeapStart 
HeapStart 


$B06 
$BOA 
$BOE 
$B10 
$B14 
$B18 
$B1C 
$B20 
$B22 
$B22 
$B24 
$B2A 
$B2E 
$B34 
$B36 
$B3E 
$B3F 
$B40 
$B54 
$B58 
$B80 
$B80 
$B80 
$B9E 
$B9F 
$BAO 
$BA4 
$BA6 
$BA8 
$BAA 
$BAC 
$BCO 
$BC2 
$BC4 
$BF4 
$BF5 
$BF6 
$C00 
$C00 
$1400 
$1C00 


long 
long 
word 
long 
long 
long 
long 
word 
word 
word 
6 
long 
6 
word 
8 
byte 
byte 
20 
long 
40 


handle to ROM resource map 

ptr to PWM buffer 

needed during boot 

ptr to global width table 

ptr to Appletalk hook 1 

ptr to Appletalk hook 2 

<unknown location> 

<unknown location> 

hardware configuration flags (two names for this global) 
SCSI configuration word (bit 15=1 if SCSI installed) 
<unknown locations> 

handle to global width table 

<unknown locations> 

boot drive driver reference number 

temporary space needed by StartBoot 
<unknown location> 

holds $FF if Timer T1 up for grabs 
<unknown locations> 

resID and menultem of last chosen menu item 
<unknown locations> 

switched variables (128 bytes) 

RMGR variables (32 bytes) 

<unknown locations> 

flag: insert map to the ROM resources 

temp SetResLoad state for calls using ROMMapInsert 
international software installed if not -1 
<unknown location> 

if nonzero, the font # for system font 

if nonzero, the system font size 

pixel height of menu bar 

<unknown location> 

formerly FlEvtMask 

handle to last family record used 

<unknown locations> 

enables fractional widths if not zero 
<unknown location> 

<unknown locations> 

Toolbox trap dispatch table (Mac Plus & SE) 
Toolbox trap dispatch table (Mac II series and SE/30) 
start of system heap (Mac Plus & SE) 

start of system heap (Mac II series and SE/30) 
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Locations defined within the trap dispatch tables: 


JADBProc $6B8 long ptr to ADBRelInit pre-/post-processing routine 
MMU32Bit $CB2 byte current address mode 

TheGDevice $CC8 long handle to current active device 

Aux WinHead $CDO long auxiliary window list header 

JVBLTask $D28 long jump vector to DoVBLTask routine 
SynListHandle $D32 long handle to synthetic font list 

MenuCInfo $D50 [??] menu color info table header 

DTQueue $D92 10 deferred task queue header 

JDTInstall $D9C long jump vector to DTInstall routine 

HiliteRGB $DA0 [??] default hilighting color 


These variables pre-empt the following A-traps (in same order as lost above): AOAE (unassigned), A82C (Pack10), 
A832 (unassigned), A834 (SetFScaleDisable), A94A (SetMFlash), A954 (NewControl), A964 through A968 
(SetMinCtl, SetMaxCtl, TestControl, DragControl, TrackControl). Note that many of these traps are assigned to ROM 
calls that have existed since 1984. After checking these locations myself, they appear to be set up for these traps, not as 
global variables. Until I can verify the accuracy of my source list, treat this group of variables with extreme caution. 
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PART 2A 


MC68000-series Microprocessor Exception Errors 


$00 reset: initial stack pointer $3C uninitialized interrupt 

$04 reset: initial program counter $40-5F [reserved by Motorola] 

$08 bus error $60 spurious interrupt 

$0C address error $64 level 1 interrupt - VIA (SY6522) 

$10 illegal instruction $68 level 2 interrupt - SCC (Z8530) 

$14 zero divide $6C level 3 interrupt - VIA and SCC together 
$18 CHK bounds check failed $70 level 4 interrupt - debug switch interrupt 
$1C TRAPV overflow trap $74 level 5 interrupt - debug switch and VIA 
$20 priveleged instruction $78 level 6 interrupt - debug switch and SCC 
$24 trace mode $7C level 7 interrupt - debug switch, VIA, SCC 
$28 $Axxx Trap dispatcher $80-BF TRAP instruction vectors 

$2C $Fxxx coprocessor instructions $CO-FF [reserved by Motorola] 

$30-3B [reserved by Motorola] $100-3FF user interrupt vectors (Mac global vars) 


PART 2B 


Macintosh™ System Errors 


NOTE: Certain MC68000 exceptions listed in part A will generate equivalent system errors. 


1 bus (illegal hardware address) 18 PACK | not found (reserved) 
2 address 19 
PACK 2 not found (Disk Initialization) 
3 illegal instruction 20 PACK 3 not found (Standard File) 
4 zero divide 21 PACK 4 not found (Floating-point) 
BS) CHK bounds check failed 22 PACK 5 not found (Transcendental) 
6 TRAPYV overflow trap 23 PACK 6 not found (International Utils) 
7 privileged instruction 24 PACK 7 not found (Binary/Decimal) 
8 trace mode 25 out of memory 
9 line 1010 trap (A-trap) 26 segment loader: can't start application 
10 line 1111 trap (F-trap) 27 "System" resource file map was clobbered 
11 miscellaneous hardware exception 28 stack overran the application heap 
12 unimplemented core routine (bad trap) 30 "Please insert the disk: " alert 
13 uninstalled interrupt (debug switch) 31 wrong disk (switch disk alert) 
14 IO core 40 
"Welcome to Macintosh" alert 
15 segment loader: no such CODE resource 41 "Can't load the Finder" alert 
16 floating point 42 "You may turn off your Macintosh" alert 
17 PACK 0 not found (List Manager) 32767 General system error 
The following system errors are reported under all ROM versions except the original 64K ROM: 
32 Memory Manager: current zone is inconsistent 
33 Memory Manager: value of ZcbFree is negative 
51 Slot Manager: unserviceable slot interrupt 
81 SANE: bad opcode passed to FP68K routine 
84 Menu Manager: menu resource has been purged 
85 Menu Manager: can't find menu bar 
86 Menu Manager: hierarchical menu error 


99 HFS stack overflowed 
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PART 2C 


Toolbox and Operating System Errors 


The errors in this section are generated by the various Mac system routines, either at the Operating 
System level or at the higher Toolbox level. These errors are then passed to the program (application, 


DA, INIT, etc.) which called the system routine. It is up to the program to handle these errors. 


Printing Manager Error 


128 


iPrAbort 


Slot Manager Initialization Errors 


14 sdmPrilnitErr 

13 sdmPRAMInitErr 

12 sdmSRTInitErr 

11 sdmInitErr 

10 sdmJTInitErr 

3 silnitSPTblErr 

2: suUnitVBLQsErr 

1 silnitSDTbIErr 
SCSI Manager Errors 

10 scComp!PhaseErr 

9 scBusTOErr 

8 scSequenceErr 

7 scMgrBusyErr 

6 scCompareErr 

5 scPhaseErr 

4 scBadparmsErr 

3 scArbNBErr 

2 scCommErr 


Miscellaneous Errors 


evtNotEnb 
noErr 

gErr 
iPrSavPFil 
vTypErr 
corErr 
unimpErr 
seNoDB 


Color Manager Errors 


-9 

-10 
-11 
-12 
-13 
-14 
-15 


iTabPurgErr 
noColMatch 
qAllocErr 

tbl AllocErr 
overRun 
noRoomErr 
seOutOfRange 


Printing Manager: user aborted printing 


initialize error: installed cards 

initialize error: Slot PRAM 

initialize error: Slot Resource Table 
initialize error: SDM 

initialize error: SDM Jump Table 

initialize error: slot priority table 

initialize error: slot VBL queues 

initialize error: slot interrupt dispatch table 


SCSIComplete failed; bus not in status phase 

bus timed out before data was ready for SCSI "blind" operations 
SCSIRBlind and SCSIWBlind 

current operation was started out of proper sequence 

SCSI Manager busy when SCSIGet was called 

SCSI Manager busy when SCSIGet was called 

bus in wrong phase for attempted operation 

bad parameter or TIB opcode 

arbitration failed during SCSIGet; bus busy 

communications error (operations timeout) 


event type not defined in system event mask 
the operation was completed normally 

queue element not found during deletion 
Printing Manager: saving spool file 

invalid queue element 

[obsolete] core routine number out of range 
[obsolete] unimplemented core routine 

no debugger installed to handle debugger traps 


[no description available] generated by: Color2Index/ITabMatch 
[no description available] generated by: Color2Index/ITabMatch 
[no description available] generated by: MakeITable 

[no description available] generated by: MakeITable 

[no description available] generated by: MakeITable 

[no description available] generated by: MakeITable 

[no description available] generated by: SetEntry 
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-16 
-17 


-18 
-19 
-20 
-21 


seProtErr 
i2CRangeErr 


gdBadDev 
reRangeErr 
seInvRequest 
seNoMemErr 


Device Manager Errors 


-17 
-18 
-19 
-20 
-21 
-22 
-23 
-23 
-24 
-25 
-26 
-27 
-27 
-28 
-29 
-30 


controlErr 
statusErr 
readErr 
writErr 
badUnitErr 
unitEmptyErr 
openErr 
openErr 
closeErr 
dRemovErr 
dInstErr 
abortErr 
iOAbort 
notOpenErr 
unitTbIFullErr 
dceExtErr 


File System Errors 


-33 
-34 
-35 
-36 
-37 
-38 
-39 
-40 
-Al 
-42 
-43 
-44 
-45 
-46 
-A7 
-48 
-49 
-50 


-51 
-52 
-53 
-54 
-55 
-56 
-57 


dirFulErr 
dskFulErr 
nsvErr 
ioErr 
bdNamErr 
fnOpnErr 
eofErr 
posErr 
memErr 
tmfoErr 
fnfErr 
wPrErr 
fLckdErr 
vLckdErr 
fBsyErr 
dupFNErr 
opWrErr 
paramErr 


rfNumErr 
gfpErr 
volOffLinErr 
permErr 
volOnLinErr 
nsDrvErr 
noMacDskErr 


[no description available] generated by: SetEntry 
[no description available] generated by: SetEntry 


no description 
no description 
no description 
no description 


generated by: SetEntry 
generated by: SetEntry 
generated by: SetEntry 
generated by: SetEntry 


ose 
oa 


driver can't handle control calls 

driver can't handle status calls 

driver can't handle read calls 

driver can't handle write calls 

driver refnum isn't in unit table 

driver refnum unit table entry is an empty (zero) handle 
R/W permission conflicts with open permission 
couldn't open RAM serial driver (64K ROM) 
[obsolete] 

tried to remove an open driver 

Drvrlnstall couldn't find driver in resource file 
10 call aborted by KillIO 

Printing Manager: I/O abort error 

driver not open 

unit table full 

dce extension error 


MFS directory full 

disk full 

no such volume 

1/O error 

bad name (name is zero-length or contains a colon) 
file not open 

end of file reached during a read 

tried to position before start of file 

[obsolete] memory full on open 

too many files open 

file not found 

disk is locked (hardware) 

file is locked 

disk is locked (software) 

file busy (delete); one or more files are open 

file with same name & version# already exists 

file already open with write permission 

error in user parameter list (plus other errors) 

File Manager: no such disk (and no default disk exists) 
Disk Driver: bad positioning information 

Disk Init Package: bad drive number 

refnum specifies a nonexistent access path 

error during Get file position call (GetFPos) 
volume not online (was ejected) 

tried to open a locked file for writing 

volume already in drive 

no such drive (specified drive number not in drive queue) 
not a Mac diskette; disk doesn't have Mac directory 
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-58 extFSErr volume belongs to an external file system 
-59 fsRnErr rename ran into problems 

-60 badMDBErr bad master directory block - reinit the disk! 
-61 wrPermErr access path doesn't allow writing 


Font Manager Errors 


-64 fontDecError error during font declaration 
-65 fontNotDeclared font not declared 
-66 fontSubErr font substitution occured 


Disk Errors (range: -64 through -84 inclusive) 


-64 lastDskErr last of the low-level disk errors (in reverse order) 

-64 noDriveErr drive not installed/connected 

-65 offLinErr operation requested for an offline disk 

-66 noNybErr couldn't find 5 nibbles in 200 tries (blank disk) 

-67 noAdrMkErr couldn't find address mark 

-68 data VerErr read-verify compare failed 

-69 badCksmErr address mark checksum didn't check 

-70 badBtSlpErr bad address mark bit slip nibbles 

-71 noDtaMkErr couldn't find a data mark header 

-72 badDCksum bad data mark checksum 

-73 badDBtSlp bad data mark bit slip nibbles 

-74 wrUnderrun write underrun occurred 

-75 cantStepErr step handshake failed (drive fault) 

-76 tkOBadErr can't find track 0 

-77 initIWMErr unable to initialize [WM (disk controller chip) 

-78 twoSideErr tried to read 2nd side on a single sided drive 

-79 spdAdjErr unable to correctly adjust 400K drive speed 

-80 seekErr track number bad on address mark (drive fault) 

-81 sectNFErr sector not found on track 

-82 fmt1 Err can't find sector O after track format 

-83 fmt2Err can't get enough sync 

-84 verErr track failed to verify 

-84 firstDskErr first of the low-level disk errors (in reverse order) 
Clock Chip Errors 

-85 clkRdErr unable to read clock 

-86 clkWrErr time written did not verify 

-87 prWrErr Parameter RAM written didn't verify 

-88 prinitErr InitUtil found the PRAM uninitialized (status not $A8) 


Device Driver Errors 


-89 revrErr [obsolete] SCC receiver error (framing, parity, OR) 
-90 breakRecd [obsolete] Break received (SCC) 
AppleTalk Errors 

-91 ddpSktErr DDP socket error: socket already active; not a known socket; socket table 
full; all dynamic socket numbers in use 

-92 ddpLenErr DDP datagram or ALAP data too long 

-93 noBridgeErr no such bridge 

-94 lapProtErr ALAP protocol errors, attach or detach 

-95 excessCollsns ALAP too many (over 32) collisions or line sensed in use 
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-97 portInUse driver open error: port is already in use 
-98 portNotCf driver open error: port not configured for this connection 


Memory Manager Errors (not available on 64K ROM) 


-99 memROZErr hard error in read-only zone 
-99 memROZWarn soft error in read-only zone 


Scrap Manager Errors 


-100 noScrapErr no scrap exists 
-102 noTypeErr no data of that type in scrap 


Memory Manager Errors 


-108 memFullErr not enough room in heap zone 

-109 nilHandleErr NIL (zero) master pointer (handle is empty) 
-110 memAdrErr [obsolete] address was odd or out of range 

-111 memW2ZErr attempt to operate on a free block 

-112 memPurErr attempt to purge a locked or non-purgable block 
-113 memAZErr [obsolete] address in zone check failed 

-114 memPCErr [obsolete] pointer check failed 

-115 memBCErr [obsolete] block check failed 

-116 memSCErr [obsolete] size check failed 

-117 memLockedErr block is locked 


File System Errors (not available on 64K ROM) 


-120 dirNFErr directory not found 

-121 tmwdoErr too many working directories open 

-122 badMovErr tried to move into offspring 

-123 wrg VolTypErr tried to do an HFS operation on a nonHFS volume 
-124 volGoneErr Server volume has been disconnected 

-126 mBarNFnd Menu Manager: MBDF not found 

-127 hMenuFindErr could not find Hierarchical menu's parent (MenuKey) 
-127 fsDSIntErr internal file system fault 


Color Quickdraw & Color Manager Errors 


-150 cMatchErr Color2Index failed to find an index 

-151 cTempMemErr failed to allocate memory for temporary structures 
-152 cNoMemErr failed to allocate memory for structure 

-153 cRangeErr range error on colorTable request 

-154 cProtectErr colorTable entry protection violation 

-155 cDevErr invalid graphics device type 

-156 cResErr invalid resolution for MakeITable 


Resource Manager Errors 


-192 resNotFound resource not found 

-193 resFNotFound resource file not found 

-194 addResFailed AddResource failed 

-195 addRefFailed [obsolete] AddReference failed 
-196 rmvResFailed RmveResource failed 

-197 rmvRefFailed [obsolete] RmveReference failed 


Resource Manager Errors (not available on 64K ROM) 
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-198 
-199 


resAttrErr 
mapReadErr 


Sound Manager Errors 


-200 
-201 
-203 
-204 
-205 
-206 


noHardware 
notEnoughHardware 
queueFull 
resProblem 
badChannel 
badFormat 


Slot Manager Errors 


-290 
-290 
-290 


smSDMInitErr 
smSRTInitErr 
smPRAMInitErr 
smPrilnitErr 
smEmptySlot 
smCRCFail 
smFormatErr 
smRevisionErr 
smNoDir 
smLWTstBad 
smNosInfoArray 
smResrvErr 
smUnExBusErr 
smBLFieldBad 
smFHBlockRdErr 
smFHBIkDispErr 
smDisposePErr 
smNoBoardsRsrc 
smGetPRErr 
smNoBoardId 
smIntStatVErr 
smIntTblVErr 
smNoJmpTbl 
smBadBoardId 
smBusErrTO 
smBadRefld 
smBadsList 
smReservedErr 
smCodeRevErr 
smCPUErr 
smsPointerNil 
smNilsBlockErr 
smSlotOOBErr 
smSelOOBErr 
smNewPErr 
smBlkMoveErr 
smCkStatusErr 
smGetDrvrNamErr 
smDisDrvrNamErr 
smNoMoresRsrcs 
smsGetDrvrErr 
smBadsPtrErr 
smByteLanesErr 
smOffsetErr 


attribute prohibits the operation 
resource map is garbled 


supporting hardware for selected synthesizer doesn't exist 
no more channels for selected synthesizer 

queue is full 

problems encountered while loading resource 

bad channel queue length 

bad handle to 'snd ' resource 


SDM could not be initialized. 

Slot Resource Table could not be initialized. 
Slot Resource Table could not be initialized. 
Cards could not be initialized. 

No card in slot 

CRC check failed for declaration data 

bad FHeader format in declaration ROM 

bad revison number in declaration ROM 
Directory offset is zero 

Long Word Test field was not $5A932BC7. 
SDM couldn't obtain memory for the sInfo array 
Reserved field not zero (fatal error) 
Unexpected bus error occurred 

bad ByteLanes field 

FHeader block couldn't be read 

FHeader block couldn't be deleted (disposed of) 
_DisposPointer error 

No Board sResource. 

Error occured during _sGetPRAMRec (See SIMStatus) 
No Board ID 

The InitStatus_V field was negative after primary init 
Slot Resource Table initialization failed 

SDM jump table could not be created 

bad Board ID, re-init the PRAM record 
BusError timeout 

Reference ID not found in List 

ID's in sList aren't in ascending order 
Reserved field not zero 

Code revision is wrong (sExec) 

CPU field is wrong (sExec) 

sPointer is zero: no sList specified 

Nil (zero-length) sBlock error 

Slot out of bounds error 

Selector out of bounds error 

_NewPointer error 

_BlockMove error 

bad slot status (InitStatus_A,V) 

Error occured during _sGetDrvrName. 

Error occured during _sDisDrvrName. 

No more sResources 

Error occurred during _sGetDrvr 

Bad sPointer was passed to an SDM routine 
bad byteLanes value was passed to an SDM routine 
Offset was too big 
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-349 
-350 
-351 


smNoGoodOpens 
smSRTOvrFIlErr 
smRecNotFnd 


Slot Manager Error 


-360 
AppleTalk Errors 


-1024 
-1025 
-1026 
-1027 
-1028 
-1029 
- 1066 
-1067 
-1068 
-1069 
-1070 
-1071 
-1073 
-1073 
-1074 
-1075 
-1096 
-1097 
-1098 
-1099 
-1100 
-1101 
-1102 
-1103 
-1104 
-1105 


slotNumErr 


nbpBuffOvr 
nbpNoConfirm 
nbpConfDiff 
nbpDuplicate 
nbpNotFound 
nbpNISErr 
aspBadVersNum 
aspBufTooSmall 
aspNoMoreSess 
aspNoServers 
aspParamErr 
aspServerBusy 
aspSessClosed 
aspSizeErr 
aspTooMany 
aspNoAck 
reqFailed 
tooManyReqs 
tooManySkts 
badATPSkt 
badBuffNum 
noRelErr 
cbNotFound 
noSendResp 
noDataArea 
reqAborted 


No opens were successful in the loop. 
sResource table overflowed 
Record not found in the sResource table 


bad slot number 


NBP buffer overflow 

NBP name not confirmed 

NBP name confirmed for different socket 
NBP duplicate name found 

NBP name does not exist 

NBP names information socket error 
Server cannot support this ASP version 
Buffer too small 

No more sessions on server 

No servers at that address 

Parameter error 

Server cannot open another session 
Session closed 

Command block too big 

Too many clients (server error) 

No ACK on attention request (server err) 
ATPSndRequest failed: retry count exhausted 
ATP too many concurrent requests 

ATP too many responding sockets 

ATP bad responding socket 

ATP bad sequence number 

ATP no release received 

ATP control block does not exist 
ATPAddRsp issued before ATPSndRsp 
too many active ATP calls 

request was aborted 


Application Errors (range: -2000 through -2999 inclusive) 


reserved for use by the current application 


AppleTalk Errors 


-3101 
-3102 
-3103 
-3104 
-3105 
-3106 
-3107 
-3108 
-3109 


buf2SmallErr 
noMPPErr 
cksumErr 
extractErr 
readQErr 
atpLenErr 
atpBadRsp 
recNotFnd 
sktClosedErr 


DDP datagram or ALAP frame too big for buffer 

MPP driver not installed 

DDP bad checksum 

NBP tuple doesn't exist in buffer 

socket or protocol type bad or doesn't exist in table 
ATP response message too long 

bad response from ATPRequest 

ABRecord doesn't exist 

async call aborted before completion: socket was closed 


Printing Manager Errors (occur with Laserwriters) 


-4096 
-4097 
-4098 


[no name declared] 
[no name declared] 
[no name declared] 


no free Connect Control Blocks available 
bad connection refNum 
request already active 


PAGE 


OTHE MAC ALMANAC II 


-4099 
-4100 
-4101 


AppleTalk Errors 


[no name declared] 
[no name declared] 
[no name declared] 


afpAccessDenied 
afpAuthContinue 
afpBadUAM 
afpBadVersNum 
afpBitmapErr 
afpCantMove 
afpDenyConflict 
afpDirNotEmpty 
afpDiskFull 
afpEofError 
afpFileBusy 
afpFlatVol 
afpItemNotFound 
afpLockErr 
afpMiscErr 
afpNoMoreLocks 
afpNoServer 
afpObjectExists 
afpObjectNotFound 
afpParmErr 
afpRangeNotLocked 
afpRangeOverlap 
afpSessClosed 
afpUserNotAuth 
afpCallNotSupported 
afpObjectT ypeErr 
afpTooManyFilesOpen 


[no description available] 


afpServerGoingDown 
afpCantRename 
afpDirNotFound 
afpIconTypeError 


_SysEnvirons Errors 


write request too big 
connection just closed 


printer closed or does not exist 


[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 
[no description available 


Rea Sa ee a ee ee ee ee a ea ee ee ee ee ee ee ee ee ee ee le 


no description available 
no description available 
no description available 
no description available 


ose 
Sas ea ea 


-5500 envNotPresent returned by glue - _SysEnvirons trap does not exist 
-5501 envBadVers Version non-positive; no information was returned 
-5502 envVersTooBig Version bigger than _SysEnvirons routine can handle 
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PART 3A 


Macintosh™ Trap Dispatcher 


The Trap Dispatcher is the part of the Macintosh Operating System that routes system calls to the 
actual routines. The Trap Dispatcher has been revised two times since its initial release, totaling 3 
versions. The earliest version was part of the original 64K ROM shipped with the 128K and 512K 
Macs. The first revision appeared in the Mac Plus 128K ROM and the second (and last) revision 
appeared in all later Mac models. 

The Trap Dispatcher takes advantage of a special feature of the 68000 microprocessor called 
unimplemented instructions . These instructions, like all other 68000 instructions, are 16 bits long (2 
bytes) and can be represented by four hex digits. Unimplemented instructions always begin with the 
hex digits A or F and can contain anything in the last 3 digits. Whenever the 68000 gets such an 
instruction, it automatically performs a trap . The 68000 fetches an address from a memory location 
predetermined by Motorola and then jumps to that address. The Mac ROM startup code automatically 
stores the starting location of the Trap Dispatcher into this specific memory location when the system is 
powered up or rebooted (the Trap Dispatcher itself is also located in the ROM). Unimplemented 
instructions are called A-traps or F-traps, depending on the first hex digit of the instruction. 

Motorola reserved all F-traps for math coprocessor instructions, and allowed the OEM, i.e. Apple, 
free use of A-traps. Apple in turn built the whole Macintosh Operating System around A-traps. All 
system calls were numbered and were split into two broad categories, called Toolbox Traps and 
Operating System (OS) Traps. Each system call was issued its own A-trap, or trap word, containing its 
own trap (system call) number. Apple built the Trap Dispatcher to handle A-traps on the Macintosh. 

Since any A-trap causes the 68000 to invoke the Trap Dispatcher, the Trap Dispatcher must decode 
the last 3 digits of the A-trap to figure out which system call to execute. The diagram below shows how 
the Trap Dispatcher decodes A-traps: 


ToolBou Traps Operating System Traps 
Sample: AQF? _Launch 4 Sample: AO? to 
GEE 0 4g IS WW 17 2 Wl WM 49 


[Se Trap nator Trap Nurniber $A S-Bit Trap Muraber 
Mot Used Preserve Register 4G 


Auto-Piop Flags 
Toolbox "05 Routine  ; Toolbox (OS Routine 


Trap word bits are defined as follows. 

Bits 15 through 12 are set to the binary pattern 1010 (hexdecimal A) for all traps. 

Bit 11 determines the trap's category: 1 for Toolbox traps and 0 for Operating System traps. 

For OS traps, bits 10 and 9 are used for flags, whose meanings depend on the routine being 
called. For Toolbox traps, bit 10 is the auto-pop bit. If it is set, the Trap Dispatcher will remove, or 
"pop", the return address from the top of the stack and throw it out. It will then pop the stack again and 
use that address as the return address. This feature supports languages such as Lisa Pascal that always 
JSR'd to a table of trap words (instead of inserting the trap words inline with the code). 

Bit 9 is a reserved bit in Toolbox trap words in the 64K and 128K ROMs. Apple added the bit to 
the trap number on all later ROMs. 

Bit 8 is used by OS traps to preserve the 68000's register AO across a system call. If the bit is 0, 
register AO is saved before the system call begins execution and restored after it finishes. If the bit is 1, 
register AO is not saved and restored (allows OS routines that resturn a value in AO to work). 

Bits 7 through 0 comprise all or part of the trap number for all traps. 
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PART 3B 


Macintosh™ Traps 


With the exception of the original 64K ROM found in 128K and 512K Macintoshes, all Mac 
ROM sets are based on the 128K ROM found in the Mac 512KE and Plus. The ROMs in all later 
Mac models contain some additions not in the 128K ROM. These additions are marked by asterisk (*) 
to the left of their name. Apple has tried to retrofit these additional traps into older Macs (that don't have 
them in ROM) by using the System software to install them in RAM, one reason newer systems are so 
huge. However, Apple excluded certain goups of traps from the retrofit process. A good example is 
Color QuickDraw, which is available only on Macs that have it in ROM (SE/30 and II series). 

While Apple has made many additions to the ROM trap set, only two traps have been removed. 
Existing only in the original 64K ROM, the obscure Resource Manager traps AddReference and 
RemoveReference never found much use, leading Apple to declare them "obsolete" and not include 
them in all later ROMs. These routines haven't been supported since 1985 and should not be used (in 
the list these two routines are marked with a black dot "e"). In fact, they were described only in the 3- 
ring binder and phone book editions of Inside Macintosh and weren't included in the final release. 

All ROM traps are given in 68000 assembly language format. Traps in boldface are bundles of 
several subroutines. Listings of the subroutines follow the general list. Be aware that some trap names 
differ from their high-level language counterparts. The reason: the original Lisa assembler limited trap 
names to 8 significant letters (including the initial underscore), and would thus see the two names 
_UnloadSeg and _UnloadScrap as representing the same trap. Changing the spelling of one of the two 
traps resolves the name conflict (thus, _UnloadSeg becomes _UnlodeScrap). In the MDS and MPW 
assemblers, Apple increased the character limit to 31. While the new limit would eliminate all conflicts, 
Apple made the misspelled names permanent. 

For a detailed description of the trap word mechanism, see Part 3A. 


* _ADBOp $A07C e _AddReference $A9AC _ Allocate $A010 
* _ADBRelInit $A07B _AddResMenu $A94D * — _ AllocCursor $AAID 
* _AddComp $AA3B _AddResource $A9AB _AngleFromSlope $A8C4 
_AddDrive $A04E * _ AddSearch $AA3A _AppendMenu $A933 
_AddPt $A87E _ Alert $A985 * —_ AttachVBL $A071 
_BackColor $A863 _BitClr $A85F _BitTst $A85D 
_BackPat $A87C _BitNot $A85A _BitXor $A859 
* —_BackPixPat $AAOB _BitOr $A85B _BlockMove $A02E 
_BeginUpdate $A922 _BitSet $A85E _BringToFront $A920 
_BitAnd $A858 _BitShift $A85C _ Button $A974 
* ~~ CalcCMask $AA4F * _CloseCPort $A87D * — _CopyPixMap $AA05 
_CalcMask $A838 _CloseDeskAcc $A9B7 * —_CopyPixPat $AA09 
_CalcMenuSize $A948 _CloseDialog $A982 _CopyRgn $A8DC 
_CalcVBehind $A90A _ClosePgon $A8CC _CouldAlert $A989 
_CalcVis $A909 _ClosePicture $A8F4 _CouldDialog $A979 
_CautionAlert $A988 _ClosePort $A87D _Count! Resources $A80D 
_Chain $A9F3 _CloseResFile $A9DA _Count1Types $A81C 
_ChangedResource $ADAA _CloseRgn $A8DB * —_CountADBs $A077 
* _CharExtra $AA23 _CloseWindow $A92D _CountMItems $A950 
_CharWidth $A88D _CmpString $A03C _CountResources $A99C 
_CheckItem $A945 * _Color2Index $AA33 _CountTypes $A99E 
_CheckUpdate $A911 _ColorBit $A864 _Create $A008 
_ClearMenuBar $A934 _CompactMem $A04C _CreateResFile $A9B1 
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_ClipAbove $A90B _Control $A004 _CurResFile $A994 
_ClipRect $A87B _CopyBits $A8EC 
_Close $A001 _CopyMask $A817 
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Trap name........... Trai Trap name........... Trai Trap name........... Trai 
_Date2Sec $A9C7 * _DisposCIcon $AA25 _DragWindow $A925 
_Delay $A03B _DisposControl $A955 _Draw1Control $A96D 
* _DelComp $AA4D * _DisposCTable $AA24 _DrawChar $A883 
_Delete $A009 _DisposDialog $A983 _DrawControls $A969 
_DeleteMenu $A936 * _DisposGDevice $AA30 _DrawDialog $A981 
* —_DelMCEntries $AA60 _DisposHandle $A023 _DrawGrowlIcon $A904 
_DelMenultem $A952 _DisposMenu $A932 _DrawMenuBar $A937 
* _DelSearch $AA4C * _DisposPixMap $AA04 _DrawNew $A90F 
_DeltaPoint $A94F * _DisposPixPat $AA08 _DrawPicture $A8F6 
_Dequeue $A96E _DisposPtr $A0IF _DrawString $A884 
_DetachResource $A992 _DisposRgn $A8D9 _DrawText $A885 
_DialogSelect $A980 _DisposWindow $A914 _DrvrInstall $A03D 
_DiffRgn $A8E6 * _DoVBLTask $A072 _DrvrRemove $A03E 
_DisableItem $A93A _DragControl $A967 * _DTiInstall $A082 
* _DispMCEntries $AA63 _DragGrayRgn $A905 
* _DisposCCursor $AA26 _DragTheRgn $A926 
_Eject $A017 _Enqueue $A96F _EraseRect $A8A3 
_Elems68K $A9EC _EqualPt $A881 _EraseRgn $A8D4 
_EmptyHandle $A02B _EqualRect $A8A6 _EraseRoundRect $A8B2 
_EmptyRect $A8AE _EqualRgn $A8E3 _ErrorSound $A98C 
_EmptyRgn $A8E2 _EraseArc $A8CO _EventAvail $A971 
_EnableItem $A939 _EraseOval $A8B9 _ExitToShell $A9F4 
_EndUpdate $A923 _ErasePoly $A8C8 
_FillArc $A8C2 _Fix2Long $A840 _Frac2X $A845 
* _ FillCArc $AAI1 _Fix2X $A843 _FracCos $A847 
* — FillCOval $AAOF _FixAtan2 $A818 _FracDiv $A84B 
* _FillCPoly $AA13 _FixDiv $A84D _FracMul $A84A 
* — FillCRect $AAOE _FixMul $A868 _FracSin $A848 
* _FillCRgn $AA12 _FixRatio $A869 _FracSqrt $A849 
* _FillCRoundRect $AA10 _FixRound $A86C _FrameArc $A8BE 
_FillOval $A8BB _FlashMenuBar $A94C _FrameOval $A8B7 
_FillPoly $A8CA _FlushEvents $A032 _FramePoly $A8C6 
_FillRect $A8A5 _FlushFile $A045 _FrameRect $A8AI1 
_FillRgn $A8D6 _FlushVol $A013 _FrameRgn $A8D2 
_FillRoundRect $A8B4 _FMSwapFont $A901 _FrameRoundRect $A9BO 
_FindControl $A96C _FontMetrics $A835 _FreeAlert $A98A 
_FindDItem $A984 _ForeColor $A862 _FreeDialog $A9TA 
_FindWindow $A92C _FP68K $A9EB _FreeMem $A01C 
_Fix2Frac $A841 _Frac2Fix $A842 _FrontWindow $A924 
_GetlIxResource $A80E * _GetGDevice $AA32 _GetOSEvent $A031 
_Get lIxType $A80F _GetHandleSize $A025 _GetPattern $A9B8 
_Get1NamedResource $A820 _GetlIcon $A9BB _GetPen $A89A 
_Get1 Resource $A81F * _GetIndADB $A078 _GetPenState $A898 
* _GetADBInfo $A079 _GetIndResource $A99D _GetPicture $A9BC 
_GetAppParms $A9F5 _GetIndType $A99F _GetPixel $A865 
* _GetAuxCtl $AA44 _GetItem $A946 * — _GetPixPat $AA0C 
* —_GetAuxWin $AA42 * —_GetItemCmd $A84E _GetPort $A874 
* _GetBackColor $AAIA _GetIText $A990 _GetPtrSize $A021 
* _GetCCursor $AAIB _GetItmIcon $A93F _GetResAttrs $A9A6 
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* _GetClcon $AAIE _GetItmMark $A943 _GetResFileAttrs $A9F6 
_GetClip $A87A _GetItmStyle $A941 _GetResInfo $A9A8 
* _GetCPixel $AAI7 _GetKeys $A976 _GetResource $A9A0 
Trap name........... Trai Trap name........... Trai Trap name........... Trai 
_GetCRefCon $A9S5SA * —_GetMainDevice $AA2A _GetRMenu $A9BF 
* _GetCTable $AAI18 _GetMaxCtl $A962 _GetScrap $A9FD 
_GetCTitle $A95E * _GetMaxDevice $AA27 _GetString $A9BA 
_GetCtlAction $A96A * _GetMCEntry $AA64 * ~~ _GetSubTable $AA37 
_GetCtl Value $A960 * —_GetMClInfo $AA61 _GetTrapAddress $A 146 
_GetCursor $A9B9 _GetMenuBar $A93B * ~~ _GetVideoDefault $A080 
* _GetCVariant $A809 _GetMHandle $A949 _GetVol $A014 
* _GetCWMegrPort $AA48 _GetMinCtl $A961 _GetVolInfo $A007 
* _GetDefaultStartup $A07D _GetMouse $A972 _GetWindowPic $A92F 
* _GetDeviceList $AA29 _GetNamedResource $A9A1 _GetWMegrPort $A910 
_GetDItem $A98D _GetNewControl $A9BE _GetWRefCon $A917 
_GetEOF $A011 * _GetNewCWindow $AA46 _GetWTitle $A919 
_GetFileInfo $A00C _GetNewDialog $A97C * — _GetWVariant $A80A 
_GetFName $A8FF _GetNewMBar $A9CO _GetZone $ALIA 
_GetFNum $A900 _GetNewWindow $A9BD _GlobalToLocal $A871 
_GetFontInfo $A88B * _GetNextDevice $AA2B _GrafDevice $A872 
* _GetForeColor $AAI19 _GetNextEvent $A970 _GrowWindow $A92B 
_GetFPos $A018 * _GetOSDefault $A084 
_HandAndHand $A9E4 _HideDItem $A827 _HLock $A029 
_HandleZone $A126 _HidePen $A896 _HNoPurge $A04A 
_HandToHand $A9EI1 _HideWindow $A916 _HomeResFile $A9A4 
_HCIrRBit $A068 * — HiliteColor $AA22 _HPurge $A049 
_HFSDispatch $A260 _HiliteControl $A95D _HSetRBit $A067 
_HGetState $A069 _HiliteMenu $A938 _HSetState $A06A 
_HideControl $A958 _HiliteWindow $A91C —HUnlock $A02A 
_HideCursor $A852 _HiWord $A86A 
* _Index2Color $AA34 _InitPort $A86D * _InternalWait $A07F 
_InfoScrap $A9F9 * —_TnitProcMenu $A808 _InvalRect $A928 
_InitAll/Packs $A9E6 _InitQueue $A016 _InvalRgn $A927 
_InitApp|IZone $A02C _InitResources $A995 _InverRect $A8A4 
* _InitCport $AA01 _InitUtil $A03F _InverRgn $A8D5 
_InitCursor $A850 _InitWindows $A912 _InverRoundRect $A8B3 
_InitDialogs $A97B _InitZone $A019 _InvertArc $A8C1 
_InitFonts $A8FE _InsertMenu $A935 * — _TInvertColor $AA35 
* _TnitGDevice $AA2E _InsertResMenu $A951 _InvertOval $A8BA 
_InitGraf $A86E _InsetRect $A8A9 _InvertPoly $A8C9 
_InitMenus $A930 _InsetRgn $A8E1 _IsDialogEvent $A97F 
_InitPack $A9E5 _InsMenultem $A826 
* _KeyTrans $A9C3 _KillIO $A006 _KillPoly $A8CD 
_KillControls $A956 _KillPicture $A8F5 
_Launch $A9F2 _LoadSeg $A9FO _LongMul $A867 
_Line $A892 _LocalToGlobal $A870 _LoWord $A86B 
_LineTo $A891 _LodeScrap $A9FB 
_LoadResource $A9A2 _Long2Fix $A83F 


PAGE 


So THE MAC ALMANAC II 


Trap name........... Trai Trap name........... Trai Trap name........... Trai 
* _MakelTable $AA39 _MaxMem $A11D _MountVol $AO0F 
* _MakeRGBPat $AA0D _MaxSizeRsrc $A821 _Move $A894 
_MapPoly $A8FC _MeasureText $A837 _MoveControl $A959 
_MapPt $A8F9 * _MenuChoice $AA66 _MoveHHi $A064 
_MapRect $A8FA _MenuKey $A93E _MovePortTo $A877 
_MapRgn $A8FB _MenuSelect $A93D _MoveTo $A893 
_MaxApp!Zone $A063 _ModalDialog $A991 _MoveWindow $A91B 
_MaxBlock $A061 _MoreMasters $A036 _Munger $A9EO 
* _NewCDialog $AA4B * _NewGDevice $AA2F _NewPtr $ALIE 
_NewControl $A954 _NewHandle $A122 _NewRgn $A8D8 
* —_NewCWindow $AA45 _NewMenu $A931 _NewString $A906 
_NewDialog $A97D * _NewPixMap $AA03 _NewWindow $A913 
_NewEmptyHandle $A066 * _NewPixPat $AA07 _NoteAlert $A987 
_ObscureCursor $A856 _Open $A000 _OpenResFile $A997 
_ Offline $A035 * _OpenCport $AA00 _OpenRF $A00A 
_OffsetPoly $A8CE _OpenDeskAcc $A9B6 _OpenRFPerm $A9C4 
_OffsetRect $A8A8 _OpenPicture $A8F3 _OpenRgn $A8DA 
_OfsetRgn $A8E0 _OpenPoly $A8CB _OSEventAvail $A030 
* _OpColor $AA21 _OpenPort $A86F 
_PackO $A9E7 _PaintArc $A8BF _PlotIcon $A94B 
_Pack1 $A9E8 _PaintBehind $A90D * —_PopUpMenuSelect $A80B 
_Pack2 $A9E9 _PaintOne $A90C _PortSize $A876 
_Pack3 $A9SEA _PaintOval $A8B8 _PostEvent $A02F 
_Pack4 $A9EB _PaintPoly $A8C7 _PPostEvent $A12F 
_Pack5 $A9EC _PaintRect $A8A2 * — _ProtectEntry $AA3D 
_Pack6 $A9ED _PaintRgn $A8D3 _Pt2Rect $A8AC 
_Pack7 $A9EE _PaintRoundRect $A8B1 _PtInRect $A8AD 
_Pack8 $A816 _ParamText $A98B _PtInRgn $A8E8 
_Pack9 $A82B _PenMode $A89C _PtrAndHand $A9EF 
_Pack10 $A82C _PenNormal $A89E _PtrToHand $A9E3 
_Pack11 $A82D _PenPat $A89D _PtrToXHand $A9E2 
_Pack12 $A82E * _ PenPixPat $AA0A _PtrZone $A148 
_Pack13 $A82F _PenSize $A89B _PtToAngle $A8C3 
_Pack14 $A830 _PicComment $A8F2 _PurgeMem $A04D 
_Pack15 $A831 _PinRect $A94E _PurgeSpace $A062 
_PackBits $A8CF * —_PlotClIcon $AAIF _PutScrap $A9FE 
* _QDError $AA40 
_Random $A861 _RectRgn $A8DF * —_RGBForeColor $AA14 
_RDrvrinstall $A04F _ReleaseResource $A9A3 * —_RGetResource $A80C 
_Read $A002 _RelString $A050 e _RmveReference $A9AE 
_ReadDateTime $A039 _Rename $A00B _RmveResource $A9AD 
* _RealColor $AA36 _ResError $A9AF _RsrcMapEntry $A9C5 
_RealFont $A902 * _ReserveEntry $AA3E _RsrcZonelInit $A996 
_ReallocHandle $A027 _ResrvMem $A040 _RstFilLock $A042 
_RecoverHandle $A128 * —_RestoreEntries $AA4A 
_RectInRgn $A8E9 * —_RGBBackColor $AAI15 
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Trap name........... Trai Trap name........... Trai Trap name........... Trai 
* _SaveEntries $AA49 * —_SetGDevice $AA31 _ShowPen $A897 
_SaveOld $A90E _SetHandleSize $A024 _ShowWindow $A915 
_ScalePt $A8F8 _SetItem $A947 * _ Shutdown $A895 
* —_ScriptUtil $A8B5 * — SetItemCmd $A84F * — _ SIntInstall $A075 
_ScrollRect $A8EF _SetIText $A98F * —_SIntRemove $A076 
_SCSIDispatch $A815 _SetItmIcon $A940 _SizeControl $A95C 
_Secs2Date $A9C6 _SetItmMark $A944 _SizeRsrc $A9A5 
_SectRect $A8AA _SetItmStyle $A942 _SizeWindow $A91D 
_SectRgn $A8E4 _SetMaxCtl $A965 _SlopeFromAngle $A8BC 
* —_ SeedCFill $AA50 * —_SetMCEntries $AA65 * _SlotManager $A06E 
_SeedFill $A839 * — SetMCInfo $AA62 * Slot VInstall $A06F 
_SelectWindow $A91F _SetMenuBar $A93C * —_SlotVRemove $A070 
_SellText $A9TE _SetMFlash $A94A _SpaceExtra $A88E 
_SendBehind $A921 _SetMinCtl $A964 _StackSpace $A065 
* —_SetADBInfo $A07TA _SetOrigin $A878 _ Status $A005 
_SetAppBase $A057 * _SetOSDefault $A083 _StdArc $A8BD 
_SetApplLimit $A02D _SetPBits $A875 _StdBits $A8EB 
* _SetCCursor $AAIC _SetPenState $A899 _StdComment $A8F1 
* — SetClientID $AA3C _SetPort $A873 _StdGetPic $A8EE 
_SetClip $A879 _SetPt $A880 _StdLine $A890 
* — SetCPixel $AA16 _SetPtrSize $A020 _StdOval $A8B6 
* _SetCPortPix $AA06 _SetRecRgn $A8DE _StdPoly $A8C5 
_SetCRefCon $A95B _SetRect $A8A7 _StdPutPic $A8FO 
_SetCTitle $A95F _SetResAttrs $A9A7 _StdRect $A8A0 
_SetCtlAction $A96B _SetResFileAttrs $A9F7 _StdRgn $A8D1 
* —_SetCtlColor $AA43 _SetResInfo $A9A9 _StdRRect $A8AF 
_SetCtl Value $A963 _SetResLoad $A99B _StdText $A882 
_SetCursor $A851 _SetResPurge $A993 _StdTxMeas $A8ED 
_SetDateTime $A03A _SetStdProcs $A8EA _StillDown $A973 
* _SetDefaultStartup $A07E _SetString $A907 _StopAlert $A986 
* _SetDeskCPat $AA47 _SetTrapAddress $A047 _StringWidth $A88C 
* —_SetDeviceAttribute $AA2D * —_SetVideoDefault $A081 * — _StripAddress $A055 
_SetDItem $A98E _SetVol $A015 _StuffHex $A866 
_SetEmptyRgn $A8DD * _SetWinColor $AA41 _SubPt $A87F 
* —_SetEntries $AA3F _SetWindowPic $A92E * — _SwapMMUMode $A05D 
_SetEOF $A012 _SetWRefCon $A918 _SysBeep $A9C8 
_SetFileInfo $A00D _SetWTitle $A9IA _SysEdit $A9C2 
_SetFilLock $A041 _SetZone $A01B *  _SysEnvirons $A090 
_SetFilType $A043 _ShieldCursor $A855 _SysError $A9C9 
_SetFontLock $A903 _ShowControl $A957 _SystemClick $A9B3 
_SetFPos $A044 _ShowCursor $A853 _SystemEvent $A9B2 
_SetFScaleDisable $A834 _ShowDItem $A828 _SystemMenu $A9B5 
_SetGrowZone $A04B _ShowHide $A908 _SystemTask $A9B4 
_TEActivate $A9D8 _TEInit $A9CC * _TEStyleNew $A83E 
_TEAutoView $A813 _TEInsert $A9DE _TEUpdate $A9D3 
_TECalText $A9D0 _TEKey $A9DC _ TextBox $A9CE 
_TEClick $A9D4 _TENew $A9D2 _TextFace $A888 
_TECopy $A9D5 _TEPaste $A9DB _TextFont $A887 
_TECut $A9D6 _TEPinScroll $A812 _TextMode $A889 
_TEDeactivate $A9D9 _TEScroll $A9DD _TextSize $A88A 
_TEDelete $A9D7 _TESel View $A811 _TextWidth $A886 
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* _TEDispatch $A83D _TESetJust $A9DF _TickCount $A975 
_TEDispose $A9CD _TESetSelect $A9D1 _TrackBox $A83B 
* _TEGetOffset $A83C _TESetText $A9CF _TrackControl $A968 
Trap name........... Trai Trap name........... Trai Trap name........... Trai 
_TEGetText $A9CB _TestControl $A966 _TrackGoAway $A9IE 
_TEIdle $A9DA * —TestDeviceAttribute $AA2C 
_UnionRect $A8AB _UnlodeScrap $A9FA _UpdtDialog $A978 
_UnionRgn $A8E5 _UnmountVol $A00E _UprString $A054 
_UniquelID $A810 _UnpackBits $A8D0 _UseResFile $A998 
_UniqueID $A9C1 _UpdateResFile $A999 
_UnloadSeg $A9FI1 _UpdtControl $A953 
_ValidRect $A92A _VInstall $A033 
_ValidRgn $A929 _VRemove $A034 
_WaitMouseUp $A977 _WriteParam $A038 
_Write $A003 _WriteResource $A9BO 
_X2Fix $A844 _X2Frac $A846 _XorRgn $A8E7 
_ZeroScrap $A9FC _ZoomWindow $A83A 


Below is a list of all system traps which represent multiple routines. These traps decide which 


routine to execute by looking for a routine number either on the stack (stack-based) or in register DO 
(register-based). All traps with the exception of InternalWait expect the routine number to be passed as 
a 16-bit unsigned word. InternalWait looks for a 32-bit routine number. To call an individual routine, 
the routine number must be either pushed on the stack or placed in register DO (following the method 
expected by its parent trap). Note that all Macintosh Packages (PACK) are stack-based. 


ofS is 5s AS 28 2s fe 28 2s fe 2s fe 2s fe fe ois 28 28 2s ois 28 2s 2s 2g 2h 2s fe fe 2s 2s 2s 2s 28s 218 28 2s fe 28 2s fe 24g fe is 2g fe is 2s 218 2s ois 28 28 2s fe 2g 2s fe 2s fe ois os os ois ois 2s 2s oe 2s 2s 2s 2k fe is 2g 2s 2s ois 21s 2s 28s 2s 28 ois oie 2g 2k 2k 2k 2k oo ok 


_PACK 0 - $A9E7 LIST MANAGER Stack-based 
NOTE: First appeared in System 3.2 


LActivate 0) LDelRow 36 LNextCell 72 
LAddColumn 4 LDispose 40 LRect 76 
LAddRow 8 LDoDraw 44 LScroll 80 
LAddToCell 12 LDraw 48 LSearch 84 
LAutoScroll 16 LFind 52 LSetCell 88 
LCellSize 20 LGetCell 56 LSetSelect 92 
LClick 24 LGetSelect 60 LSize 96 
LClrCell 28 LLastClick 64 LUpdate 100 
LDelColumn 32 LNew 68 
oie 2 2c of 2 oe of ofc os 2 oe of ais os 2s oe of ais 2k 2s oie os ois 2k ofc oie of ois 2 of ois oft ois oie ofc ois 2k ois fe ofc fs 2 ofc 2 ofc fs 2 oie oft oie ois ois oie of ois of ois oie ok ois 2 ois oie oie ois oie ofc oie oie aks oie ofc fs of os oie ofc of 2s oft 2 oe of ois ok is ok ok ok ok ok ok ok 
_PACK 1 - $A9E8 Reserved 
oie 2g oe of 2 ofc of ofc fs 2s oe of ois of 2s 2k of ais 2k ais 2k oe ois oie of 2k of ois oie of ois oe ois 2 ofc ois oe ois fe ofc fs 2 ofc 2 ofc fs 2s oie oft ofc of is oie of ois of ois oie fe os 2 ois oie fe aks oie ofc 2 oe ok oe ofc os of afk oe ofc ois ais ois 2k 2k oft ois ok ok ok ok ok ok ok ok ok 
_PACK 2 - $A9E9 DISK INITIALIZATION Stack-based 
DIBadMount 0 DILoad 2 DIVerify 8 
DIFormat 6 DIUnload 4 DIZero 10 
oie 2 oe ois 2 oe of ofc os 2 oie of 2s of 2s oe of ais oie ais of of ois 2k of oie of ois 2k 2k ois oe ois 2 fe ois oie aks oie ofc fs 2 ofc 2 ofc ois 2 oie oft oie ois is oie of ois of os oie fe ois 2k ois oie of os oie ofc oie ofc aks oie ofc ois of ois oie oie ois 2s oft 2k 2k of ois ok ois ok ok ok ok ok ok ok 
_PACK 3 - $A9EA STANDARD FILE Stack-based 
SFGetFile 2 SFPPutFile 3 
SFPGetFile 4 SFPutFile 1 
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PhS os 2s 28 28 2s fe 28 2s fe 2s fe 2s fe 2 28s 2s 28 2s 2s 28 2s 2c 2g 2h 2fe fe fe 2s 2s 28 os 2s 28 28 2g 24s 28 2g fe 2g fe is 2g fe is 2s 28 2s os 28 28 2s fe 2g oie fe fe fe ois os fe ois ois 2s 2s 2s 28 2s 2s 2g fe is fe fe 2s ois 2s 2s 28s os 2s 2g oie 2g ok 2k 2k 2k oo 2 ok 


PAGE 


So THE MAC ALMANAC II 


DE ee eee ee ee ee ee ee ee ee ee ee 


_PACK 4 - $A9EB FLOATING-POINT MATH Stack-based 


NOTE: The Standard Apple Numerics Environment (SANE) declares a second name for this trap: FP68K. SANE 
also requires the data type of routine parameters; this is accomplished by setting certain high bits of the routine number 
listed below, with all high bits clear, will work for 80-bit extended- 
precision floating- point parameters. See the Apple Numerics Manual for more information. 


(and altering the 16-bit value). The numbers 


FOABS 15 FOLOGB 26 FOGETENV 3 
FOADD 0 FOMUL 4 FOSETHV 5 
FOB2D 11 FONEG 13 FOSETXCP 21 
FOCLASS 28 FONEXT 19 FOSQRT 18 
FOCMP 8 FOPROCENTRY 23 FOSUB 2 
FOCPX 10 FOPROCEXIT 25 FOTESTXCP 27 
FOCPYSGN 17 FOREM 12 FOTTI 22 
FOD2B 9 FORTI 20 FOX2Z 16 
FODIV 6 FOSCALB 24 FOZ2X 14 
FOGETHV 7 FOSETENV 1 


DE ee eee ee ee ee ee ee ee ee ee 


_PACK 5 - $A9EC TRANSCENDENTAL FUNCTIONS Stack-based 
NOTE: SANE declares a second name for this trap: _Elems68K. Also, SANE treats these routines 
in the same manner as FP68K / Pack4. See the Apple Numerics Manual for more information. 


FOANNUITY 49174 FOEXP1X 12 FORANDX 32 
FOATANX 30 FOEXP21X 14 FOSINX 24 
FOCOMPOUND 49172 FOLNX 0 FOTANX 28 
FOCOSX 26 FOLN1X 4 FOXPWRI 32784 
FOEXPX 8 FOLOG21X 6 FOXPWRY 32786 
FOEXP2X 10 FOLOG2X 2 
DE ee ee ee ee ee ee ee ee 
_PACK 6 - $A9ED INTERNATIONAL UTILITIES Stack-based 
TUDatePS tring 14 TUMagIDString 12 TUSetIntl 8 
TUDateString 0 TUMagString 10 TUTimePString 16 
TUGetIntl 6 TUMetric 4 TUTimeString 2 


DEE ee eee eee ee ee ee ee ee ee 


_PACK 7 = $A9EE BINARY/DECIMAL CONVERSION Stack-based 
NOTE: SANE declares a second name for this trap: _DecStr68K, and uses routines 2, 3, and 4. No high bits are 
required by SANE for these routines, unlike packages 4 and 5. 

CStr2Dec 4 __NumToString 0 
Dec2Str 3 PStr2Dec 2 


PhS ois 28 28 28 2g fe 2S 2g 2g 2g fe 2 fe fe 2s 218 28 2s 2s 28 2s oe fe 2h 24s 24g fe 2s 2s 28 as 28s 28 2S 2g he 28 2g fe 2g fe a 2g fe is ois 218 2s ois 28 2S 2s fe 2g 2s 2g 2s fe 2s os eis 2s 2s 2s 2c 2s 2s 2c fe fe fs 2g oie 2s ois 2s 2s 28s os 2s 2s oie 26 2k 2k 2k 2k 2 2 2 ok 


_HFSDispatch = $A260 


StringToNum 1 


Register-based 


CloseWD 2 GetFCBInfo 8 SetCatInfo 10 
CatMove 5 GetWDInfo 7 Set VolInfo 11 
DirCreate 6 LockRng 16 UnlockRng 17 
GetCatInfo 9 OpenWD 1 
DE ee eee ee ee ee ee ee ee ee 
_SCSIDispatch = $A815 Stack-based 
SCSICmd 3 * SCSIMsgOut 13 SCSISelect 2 
SCSIComplete 4 SCSIRBlind 8 SCSIStat 10 
SCSIGet 1 SCSIRead 5 SCSIWBlind 9 
SCSIInstall 7 SCSIReset 0 SCSIWrite 6 
* SCSIMsgIn 12 * SCSISelAtn 11 


DE ee ee ee ee ee ee ee ee ee ee 


* _InternalWait $A07F basis unknown 
NOTE: This trap was listed in Inside Macintosh without an accompanying description. 


PAGE 


So THE MAC ALMANAC II 


SetTimeout 0 GetTimeout 1 
oie ie 2c ois 2s ofc fs ofc fs 2 of of ais of 2s oe of ois oe ais 2k of ais 2k of oie of ois 2 oe ois oe ois oie oft ois oie ois oie ofc fs oie ofc 2 ofc of 2 oie oft oie ois ais oie of ois oft ois oie ok ok 2k ois 2k of ois oie ofc oie oe ois oie ofc fs oe of oie ofc of is oft 2k oe of ois ok ks 2 ok ok ok ok ok ok 
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DE ee eee ee ee ee ee ee ee ee ee ee 


* _ScriptUtil $A8B5 stack-based [long] 

NOTE: Routine number expected to be a 32-bit long integer on stack 
smChar2Pixel 22 smFontScript 0 smMeasureJust 32 
smCharByte 16 smGetEnvirons 8 smPixel2Char 20 
smCharType 18 smGetScript 12 smSetEnvirons 10 
smDrawJust 30 smHiliteText 28 smSetScript 14 
smFindWord 26 smIntlScript 2 smTranslit 24 
smFont2Script 6 smKybdScript 4 

DE ee eee ee ee ee ee ee ee ee ee ee ee 

* Shutdown $A895 Stack-based 
ShutDwniInstall 3 ShutDwnRemove 4 
ShutDwnPower 1 ShutDwnStart 2 

DE ee ee ee ee ee ee ee i ee ee 

* _SlotManager $A06E Register-based 
InitPRAMRecs 37 sFindsRsrcPtr 48 sReadByte 0 
InitSDec 1 Mgr 32 sFindStruct 6 sReadDrvrName 25 
InitsRsrcTable 41 sGetBlock 5 sReadInfo 16 
sCalcsPointer 44 sGetcString 3 sReadLong 2 
sCalcStep 40 sGetDriver 45 sReadPBSize 38 
sCardChanged 34 sNextRsrc 20 sReadPRAMRec 17 
sCkCardStatus 24 sNextTypesRsrc 21 sReadStruct 7 
sdeleteSRTRec 49 sOffsetData 36 sReadWord 1 
sDisposePtr 23 sPrimaryInit 33 sRsrcInfo 22 
sExec 35 sPtrToSlot 46 sSearchSRT 42 
sFindDevBase 27 sPutPRAMRec 18 sUpdateSRT 43 
sFindsInfoRecPtr 47 sReadFHeader 19 


DE ee ee ee ee ee ee ee ee ee ee ee 
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PART 4 


Unit Table Entries (Device Driver) 


0 [reserved] 8 .BOut (Printer port async out) 

1 hard disk driver (MacXL/HD20) 9 -.MPP (AppleTalk) 

2 .Print 10 .ATP (AppleTalk) 

3 Sound 11 [reserved] 

4 Sony (disk driver) 12-26 desk accessories in System file 

5 .AIn (Modem port async in) 27-31 desk accessories in application files 
6 -AOut (Modem port async out) 32-39 SCSI drivers 0-7 

7 .BIn (Printer port async in) 40-47 [reserved] 


PART 5 


Font Numbers for Apple® Screen Fonts 


Font FontNo. ResID—CS Font Font No. Res ID 
Chicago 0 0 [reserved] 13 1664 
application font 1 128 [reserved] 14 1792 
New York 2 256 [reserved] 15 1920 
Geneva 3 384 [reserved] 16 2048 
Monaco 4 512 [reserved] 17 2176 
Venice 5 640 [reserved] 18 2304 
London 6 768 [reserved] 19 2432 
Athens 7 896 Times Roman 20 2560 
San Francisco 8 1024 Helvetica 21 2688 
Toronto 9 1152 Courier 22 2816 
Seattle 10 1280 Symbol 23 2944 
Cairo 11 1408 Taliesin 24 3072 
Los Angeles 12 1536 [reserved] 25 3200 
NOTES: 


1. Font numbers 0-127 are reserved for future Apple fonts. 

2. Font numbers 128-383 are reserved for vendor assignments. 

3. Font numbers 384-511 available for use by anyone. 

4. Old copies of Apple's Font/DA Mover (older than version 3.x) will not handle fonts that have negative resource 
ID's (i.e. font numbers 256 and up), affecting half the font numbers reserved for vendors and 
all of the general-use font numbers. 
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PART 6 


Power-up/Reset Memory Tests 
sample RAM test fail: @4@830 


0008000 


$eé= 8 OB a 


Etror Code} UUES UU UL» 


Test Number $29 @ @ 


OFOOOD 


Edge of Motherboard J 


When the Mac is first turned on, it performs several internal tests before displaying the insert disk 
icon. Although Apple never published details about these tests, this information was leaked to the public 
soon after the Mac's introduction in 1984. 

Every time the Mac performs a cold start, usually when power is first applied (or even after a bad 
system crash), the boot code in the ROM executes 5 memory tests. The first one is a ROM self-test, 
and the remaining four test the RAM. If any of these tests fail, obviously the Mac in question will need 
logic board repairs. To help their technicians diagnose the trouble, Apple distributed a diagram similar 
to the one above. 

The diagram was released for the first Mac motherboard, used in the old 128K and 512K Macs. To 
the best of my knowledge, Apple has not released diagrams for Macs built with SIMM RAM modules 
(Mac Plus and all later models). But I do understand that Apple used a chip-numbering system for 
SIMMs similar to the one used for the soldered-in RAM chips of the original motherboards. 

The sad-Mac screen is used to report memory test failures on all Mac models. The sad-Mac screen 
itself is generated by the System Error Handler when it doesn't have the normal system error box 
loaded (such as before the Mac can boot, or after a bad enough crash). Below the sad-Mac icon are 6 
hexadecimal digits which describe the system error. 

For memory test failures, the first two hex digits always report the test number. The second pair of 
digits represent the chips in row 'G' on the motherboard (see diagram), and the last pair of digits 
describe row 'H'. Starting from the left, each bit corresponds to a particular chip. If the chip is bad, the 
bit is set to'l', otherwise the bit is zero. 

For system errors, the first pair of hex digits will always be a OF. The last four digits represent the 
error code (which will be the normal system error ID code converted into hex). The table below lists 
both the OF and its associated error IDs (listed as processor errors): 


Test Number and Description Error Code 
01 ROM test failed (meaningless) 
02 Memtest - Bus subtest Identity of suspected bad RAM chip(s) 


03 Memtest - ByteWrite 

04 Memtest - Mod3test 

05 Memtest - Add uniqueness 
06 through OE - not used 


OF Exception - MC68000 error Processor error (listed below 

0001 Bus Error 0007 privilege violation 
0002 address error 0008 trace 

0003 illegal instruction 0009 A-trap 

0004 zero divide OOOA F-trap 
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0005 check instruction OOOB other exceptions 
0006 trapv instruction 000D NMI (interrupt button) 
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PART 7A 
Standard ASCII Chart 


This ASCII chart is labeled in hexadecimal. The ASCII character code for any character is obtained 
by adding the character's row and column numbers, e.g. ASCII code for "g" is 60+7 or $67 hex. 


ER REAM ADB E EE 


PART 7B 


ASCII Character Layout, Mac Plus Keyboard 


NOTE: Although there are several other Apple keyboard designs, the ASCII codes generated by 
their keys will largely follow the pattern used by the Macintosh Plus keyboard. 


Normal Unshifted 


ve ‘Bar l. «| + | 
a2 g2 [2a | 29 


(continued on next page) 
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Normal Shifted 


a teaetet 


Space Ba [ < + | 
zoo | 4a | 42 | & 
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